home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / brltty / README-CTB < prev    next >
Text File  |  2009-05-14  |  3KB  |  67 lines
  1. Contraction Tables
  2. ------------------
  3.  
  4. Files with names of the form *.ctb are contraction tables, and with names of 
  5. the form *.cti are contraction subtables. They are used by BRLTTY to translate 
  6. character sequences on the screen into their corresponding contracted braille 
  7. representations.
  8.  
  9. A contraction table consists of a sequence of entries, one per line, which 
  10. define how character sequences are to be represented in braille. UTF-8 
  11. character encoding must be used. White-space (blanks, tabs) at the beginning of 
  12. a line, as well as before and/or after any operand, is ignored. Lines 
  13. containing only white-space are ignored. If the first non-white-space character 
  14. of a line is "#" then that line is a comment and is ignored.
  15.  
  16. The format of a contraction table entry is:
  17.  
  18.    directive operand ... [comment]
  19.  
  20. Each directive has a specific number of operands. Any text beyond the last 
  21. operand of a directive is interpreted as a comment. The order of the entries 
  22. within a contraction table is, in general, anything that is convenient for its 
  23. maintainer(s). An entry which defines an entity, e.g. class, must precede all 
  24. references to that entity.
  25.  
  26. Entries which match character sequences are automatically rearranged from 
  27. longest to shortest so that longer matches are always preferred. If more than 
  28. one entry matches the same character sequence then their original table 
  29. ordering is maintained. Thus, the same sequence may be translated differently 
  30. under different circumstances.
  31.  
  32.  
  33. The Characters Operand
  34. ----------------------
  35.  
  36. The first operand of a character sequence matching directive is the character 
  37. sequence to be matched. Each character within the sequence may be:
  38. *  Any single character other than a backslash or a white-space character.
  39. *  A backslash-prefixed special character. These are:
  40.    -  \b          The backspace character.
  41.    -  \f          The formfeed character.
  42.    -  \n          The newline character.
  43.    -  \o###       The three-digit octal representation of a character.
  44.    -  \r          The carriage return character.
  45.    -  \s          The space character.
  46.    -  \t          The horizontal tab character.
  47.    -  \u####      The four-digit hexadecimal representation of a character.
  48.    -  \U########  The eight-digit hexadecimal representation of a character.
  49.    -  \v          The vertical tab character.
  50.    -  \x##        The two-digit hexadecimal representation of a character.
  51.    -  \X##        ... (the case of the X and of the digits isn't significant)
  52.    -  \#          A literal number sign.
  53.    -  \<name>     The Unicode name of a character (use _ for space).
  54.    -  \\          A literal backslash.
  55.  
  56.  
  57. The Representation Operand
  58. --------------------------
  59.  
  60. The second operand of those character sequence matching directives which have 
  61. one is the braille representation of the sequence. Each braille cell is 
  62. specified as a sequence of one to eight dot numbers. A dot number is a digit 
  63. within the range 1-8 as defined by the standard braille dot numbering 
  64. convention (see README-DOTS). The special dot number 0, which may not be used 
  65. in conjunction with any other dot number, means no dots.
  66.  
  67.